home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / amok_lha / amok13.lha / With / With.doc < prev    next >
Text File  |  1993-08-15  |  3KB  |  117 lines
  1.  
  2.  
  3.                              W I T H
  4.                           =============
  5.  
  6.                     1988 by Fridtjof Siebert.
  7.                           Nobileweg 67
  8.                         7000 Stuttgart-40
  9.  
  10. What is it?
  11.  
  12.     `WITH' is a powerful new CLI-Command that allows you to start any CLI
  13.     Command several times and give it all the files that fit to a
  14.     filepattern as argument.
  15.  
  16. Arp?
  17.  
  18.     Not to make WITH unnecessarily long, WITH uses ARP's routines. So if you
  19.     don't have installed ARP jet, you'll have to copy arp.library to your libs:
  20.     directory.
  21.  
  22. How to use WITH?
  23.  
  24.     Usage: WITH <File-Pattern> <Command> [TO File] [ALL] [DIRS] [FILES] [SHOW]
  25.  
  26.     If you start WITH without an argument, you'll get it's usage.
  27.  
  28.     File-Pattern:
  29.       The file pattern is just a normal ARP or AmigaDOS file pattern.
  30.  
  31.     Command:
  32.       Command can be a cli command, or several commands with additional
  33.       options. The locations, where the found filenames are to be put, are
  34.       marked by a "$". You can use several commands and seperate them by
  35.       semicolons.
  36.  
  37.     TO File:
  38.       This optional argument specifies a file to save Command's output. You
  39.       can use this like "TYPE x TO prt:" to print the output.
  40.  
  41.     ALL:
  42.       Set this option if you want to use all files that are in
  43.       subdirectories of the files specified by the File-Pattern, too.
  44.  
  45.     DIRS and FILES:
  46.       If the option DIRS is set, Command will only be started with
  47.       directories, that fit to the file pattern. If FILES is set, commad
  48.       will only be started files. If neither DIRS nor FILES is set, with
  49.       will use files and directories.
  50.  
  51.     SHOW:
  52.       This options makes WITH display the command[s] with the inserted
  53.       filenames before it executes them. This allows you to track what's
  54.       happening when you `quiet' commands like COPY or DEL.
  55.  
  56.     You can break WITH by pressing ^D, ^E or ^F.
  57.  
  58. Examples:
  59.  
  60.     Here are some examples to make WITH's usage clear:
  61.  
  62.     WITH *.mod TYPE
  63.  
  64.       Types all files that end ".mod".
  65.  
  66.     WITH * LIST DIRS
  67.  
  68.       Lists all directories.
  69.  
  70.     WITH DF0: LIST ALL DIRS TO Directory
  71.  
  72.       This does something similar to "DIR >Directory DF0: OPT A", but uses
  73.       LIST.
  74.  
  75.     WITH DF0: "COPY $ TO RAM:" ALL FILES SHOW
  76.  
  77.       Copies all files from all directories of DF0: to the root-directory
  78.       of the ramdisk. The executed commands are displayed.
  79.  
  80.     WITH DF0:Texts/* "COPY Icons:Text.info $.info" FILES
  81.  
  82.       Copies the icon "Icons:Text.info" to all files in "DF0:Texts".
  83.  
  84.     WITH DF0:* "RENAME $ AS $.txt" ALL FILES
  85.  
  86.       Adds ".txt" to the names of all files in DF0:.
  87.  
  88.     WITH *.def "ECHO File $:; TYPE $"
  89.  
  90.       This is a bit more complex. The ";" seperates the "ECHO" from the
  91.       "TYPE" command. First, echo displays "File " plus the found Filename
  92.       and a ":". Then the file is typed by TYPE.
  93.  
  94.       The result of this command will look like this:
  95.  
  96.       File: Graphic.def:
  97.       DEFINITION MODULE Graphic;
  98.         ...
  99.       END Graphic.
  100.       File: Sound.def:
  101.       DEFINITION MODULE Sound;
  102.         ...
  103.       END Sound.
  104.       Done.
  105.  
  106.     WITH works with any commands that do not accept a filepattern. So you
  107.     can use anything, and not just your standard DOS command set.
  108.  
  109. Copyright:
  110.  
  111.   WITH is in the public domain. It can be used by anyone freely but not
  112.   commercially.
  113.  
  114.   Donations wellcome!
  115.  
  116. ---  Fridtjof.
  117.